home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_door / dctvd020.zip / DCTVOTE.TXT < prev    next >
Text File  |  1996-06-16  |  21KB  |  412 lines
  1.  
  2. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  3.  
  4.  
  5.                     DCT Voting Door v0.20, ßeta Release
  6.                              By Dan Traczynski
  7.                                June 16, 1996.
  8.  
  9.             Copyright (C) 1996 Dan Traczynski.  All rights reserved.
  10.  
  11.  
  12. ▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀
  13.  
  14.  
  15.    DCT-Vote is a deluxe voting door for any BBS software which supports the
  16. DORINFO1.DEF or DOOR.SYS drop file.  Setup is amazingly fast and easy, and
  17. the voting door will be FreeWare until v1.0, after which I'll decide whether
  18. it should continue as freeware or make it shareware.
  19.  
  20.  
  21. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  22.  
  23.                            ──═══════════════════──
  24.                               Table of Contents
  25.                            ──═══════════════════──
  26.  
  27.                Features ................................... o1
  28.                Installation ............................... o2
  29.                SysOp Hotkeys .............................. o3
  30.                Distribution & Disclaimer .................. o4
  31.                Credits/Acknowledgments .................... o5
  32.                Things to look for in upcoming releases .... o6
  33.                History - Notes from the Past .............. o7
  34.  
  35.  
  36. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  37.                                                                           o1
  38.                     ──═════════════════════════════════──
  39.                        Features of the DCT Voting Door
  40.                     ──═════════════════════════════════──
  41.  
  42. ■ Supports both DORINFOx.DEF and DOOR.SYS allowing it to be run on virtually
  43.   any bulletin board system.
  44. ■ User time-out after a configurable amount of time.
  45. ■ Auto-Deletion of old booths.
  46. ■ Lightbar selector for you eLiTe d00ds.
  47. ■ Problem users can be locked out.
  48. ■ Language support (not all of us speak English ;).
  49. ■ External ANSI file support.
  50. ■ Optional user censor (allowing you to filter out swearing).
  51. ■ Bar graphs/percentages when displaying results.
  52. ■ Users may leave their comments on each booth.
  53. ■ Colour configuration.
  54. ■ Internal SysOp-User full-screen chat mode.
  55. ■ DCT-Vote can be set to have users vote for all new booths when they login.
  56. ■ Multi-tasker capability.
  57.  
  58.  
  59. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  60.                                                                           o2
  61.                           ──════════════════════──
  62.                              Installation Guide
  63.                           ──════════════════════──
  64.  
  65.    Installation is extremely simple; all you must do is create a directory
  66. for DCT-Vote, then run CONFIG.EXE to configure DCT-Vote to your system.  You
  67. may also wish to edit DCTVOTE.FLT if you will be using the censor, as no
  68. words have been pre-defined to filter out.  DCT-Vote does not have to be run
  69. from the directory it resides in, since it automatically looks for all of its
  70. files in the its home directory.  Have your BBS call DCT-Vote via a
  71. command-line similar to "C:\BBS\DOORS\DCTVOTE\DCTVOTE.EXE /PC:\BBS".  The
  72. "/P" parameter specifies the path for DCT-Vote to read the drop file from and
  73. is only required if the drop file will not be in the current directory.  If
  74. your BBS supports memory swapping, please activate this option.
  75.  
  76.    If you would like to have your users presented with any new voting booths
  77. when they login, have DCT-Vote executed at login with the "/A" parameter for
  78. a command-line similar to "C:\BBS\DOORS\DCTVOTE\DCTVOTE.EXE /PC:\BBS /A".
  79. DCT-Vote will have users vote for all new booths that they have not yet voted
  80. for, then return to the BBS automatically.  If no new booths exist, DCT-Vote
  81. will terminate without even letting the user know that it has been run.  You
  82. may also specify "/A2" instead of "/A", and that would simply tell the user
  83. how many questions he has not yet voted on, then ask him if he would like to
  84. vote for them.  This way people would realise that the booths are there, but
  85. they are not forced into them.  You may also specify "/A3" which acts the same
  86. as "/A" but does not let users abort the voting (they can't hit ESC).
  87.  
  88.  
  89.  Command-Line Parameters
  90. ─────────────────────────
  91.  
  92.  /A[1|2|3] ·∙· Invoke Auto-Vote (1=Vote for all new booths,
  93.                                  2=Prompt then vote,
  94.                                  3=Force users to vote on new booths).
  95.                If no number is specified, it defaults to "1".   
  96.  /Bxxx     ·∙· Specify locked baud rate (i.e. /B38400).
  97.  /L        ·∙· Local mode (logs in with the SysOp's name).
  98.  /Nx       ·∙· Specify node number (not really needed unless you want it to
  99.                read DORINFO2.DEF for node 2 etc).
  100.  /Pxxx     ·∙· Specify path to drop file (i.e. /PC:\BBS).
  101.  /V        ·∙· Turn local video off.
  102.  /W        ·∙· A DOS only network is present.
  103.  
  104.  International Support
  105. ───────────────────────
  106.  
  107.    New in v0.20, support has been added so that all strings can be modified
  108. which allows the door to be translated into a different language altogether.
  109. All of the internal strings can be modified from within CONFIG.EXE, but some
  110. parts of the program allow more customisation by allowing you to design your
  111. own ANSI screens.  The following files, if they exist, will replace the
  112. internal displays.  Note that these files are not required in order for the
  113. door to function properly.
  114.  
  115.   LOGO.ANS      This replaces the default "DCT-Vote" logo that is displayed
  116.                 in the main menu.
  117.   LOCKOUT.ANS   This is shown if the user is locked out.
  118.   NOANSI.ASC    If the user's terminal does not support ANSI, this file is
  119.                 displayed instead of the hard-coded message.
  120.   INUSE.ANS     Message telling the user that someone else is using the door
  121.                 on a separate node and that he cannot enter the door at this
  122.                 time.
  123.   MAINHELP.ANS  Replaces the help box that is shown when a user hits "?" in
  124.                 the main menu.
  125.  
  126. The following imbedded codes may be used in the language prompts.
  127.  
  128.   %U  User's name.
  129.   %B  Title of the current booth being voted on.  On language prompts that
  130.       would appear in places such as the main menu, this code is "undefined".
  131.   %H  Number of booths user hasn't voted for yet.
  132.   %A  Number of active booths.
  133.   %S  Board name.
  134.   %T  A temporary string that varies with each language prompt.
  135.  
  136.  
  137.  
  138. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  139.                                                                           o3
  140.                              ──═══════════════──
  141.                                 SysOp Hotkeys
  142.                              ──═══════════════──
  143.  
  144.    SysOp hotkeys allow you to do a number of things while the user is in the
  145. door.  Hotkeys supported in this release are as follows.
  146.  
  147.         F1    ·∙· Shows the SysOp hotkeys on the status bar.
  148.         Alt∙C ·∙· Invokes the internal chat mode.
  149.         Alt∙T ·∙· Twits User.  Returns user back to the BBS.
  150.         PgUp  ·∙· Adds 5 minutes to the user's alloted time in the door.
  151.         PgDn  ·∙· Removes 5 minutes of the user's time in the door.
  152.  
  153.  
  154. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  155.                                                                           o4
  156.                        ──═══════════════════════════──
  157.                           Distribution & Disclaimer
  158.                        ──═══════════════════════════──
  159.  
  160.    DCT-Vote is copyright (C) 1996 by Dan Traczynski.  All Rights Reserved.  I
  161. encourage you to distribute it, but DO NOT by any means alter any of the
  162. files within the original archive.  The archive should be named DCTVD020.ZIP,
  163. preferably kept in its ZIP format.
  164.  
  165.    The author, Daniel Traczynski, will take no responsibility to anything
  166. that this program may or may not do to your system.  Although the program has
  167. been tested thoroughly by the support team, no guarantee can be given that it
  168. will do what it was made to do.  Nevertheless, if anything should happen, the
  169. user is totally responsible and the author will be under no obligations what-
  170. soever.  By using this program you agree to this disclaimer.
  171.  
  172.  
  173. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  174.                                                                           o5
  175.                       ──════════════════════════════──
  176.                          Credits and Acknowlegments
  177.                       ──════════════════════════════──
  178.  
  179. I'd like to thank the following people in my making of this program.
  180.  
  181. -Alan Ianson of Al's Place BBS (604)251-1817 for his support of my programs
  182.  and for allowing users to FREQ all DCT Productions from his BBS.
  183. -Francois Massonneau for his idea of adding language support and a few other
  184.  miscellaneous options.  My gratitude goes out to him for writing the French
  185.  language file.
  186. -Philip Wright for his useful suggestions and bug reports.
  187. -Justin Bourne for testing DCT-Vote remotely for me and finding some of the
  188.  bugs in the first ßeta.
  189. -Steve Lorenz for DDPlus.
  190. -Ryan Walsh on Rogue's Inn BBS for ßeta testing the program for me.  Too bad
  191.  his board went down.
  192. -Neural Meltdown BBS (604-255-5198) for being my new ßeta tester.
  193. -Mark Mcleod for bugging me for a new release and being there when I didn't
  194.  want him there. :)
  195.  
  196.  
  197. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  198.                                                                           o6
  199.                      ──══════════════════════════════──
  200.                         Things to look forward to :)
  201.                      ──══════════════════════════════──
  202.  
  203.    DCT-Vote is very new and is still in its developmental stages, so some
  204. features you may wish to see in a voting door may not be implemented yet.
  205. Most of the features that I add to this door are requests made by SysOps, so
  206. if you would like to see a new feature added to this door, by all means send
  207. me e-mail and I will try to add in your request.  I can be reached at
  208. dan.traczynski@als.dudd.uniserve.com.  If you do not have internet e-mail
  209. access, I can also be contacted via the FidoNet RA_Util echo.
  210.  
  211.    Although the booth editor is not yet completed, it will allow you to edit
  212. the basic attributes of each booth.  In the following version, I plan to have
  213. it so that you may delete/add answers as well as booths.  I will also add in
  214. a comment file editor, and as well I *may* add more external ANSI file
  215. support into the door so that SysOps can design their own screens.
  216.  
  217.    Multiple language files are possible at this time, although DCT-Vote can
  218. only allow the SysOp to select one.  In the next version, the user may select
  219. his language from whichever language files are available.
  220.  
  221.  
  222. ▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄
  223.                                                                           o7
  224.                             ──═══════════════──
  225.                                Release Notes
  226.                             ──═══════════════──
  227.  
  228.    The DCT-Vote project began on December 27, 1995.  The first public beta
  229. release was on April 17, 1996.
  230.  
  231.   + Added a new feature/Something was improved.
  232.   - Removed something.
  233.   * General comment.
  234.   > Bug fix.
  235.  
  236.  Version 0.20ß -=- June 16, 1996.
  237.    > If a user was at the spinning stick prompt and the SysOp hit a function
  238.      key or other SysOp hotkey, the stick would stop spinning.  Fixed.
  239.    > If a user "Voted for all booths" and hit ESC to stop voting on them
  240.      after voting on the first one, the "press any key" prompt would not be
  241.      displayed right.  Fixed.
  242.    > If a user was in auto-vote mode and answered "No" to the "Vote for next
  243.      booth?" prompt, the "would you like to create your own booth?" string
  244.      would not be displayed.  Fixed.
  245.    + Added language support.
  246.    + Added the external ANSI file support.
  247.    > If censoring mode was enabled, it would not filter anything entered on
  248.      the second line of the question in each booth.  Fixed.
  249.    + DCT-Vote can now optionally prompt the user to confirm his voting
  250.      selection.
  251.    + If the drop file says that the user doesn't have ANSI turned on, DCT-Vote
  252.      checks to make sure and lets him in if the user's terminal program
  253.      supports ANSI.
  254.    + The string input strings now allow cursor editing keys as well as support
  255.      word wrap.
  256.    + Added an INUSE.FLG file so there shouldn't be any more runtime errors on
  257.      multi-node systems.
  258.    + Added the internal SysOp-User full-screen chat mode (the screen doesn't
  259.      always redraw after exiting chat though as I haven't completed this
  260.      feature yet).
  261.    + Users may now add more than one answer per booth if the SysOp allows it.
  262.    + Added "/A2" and "/A3" parameters.
  263.    * I changed the structures of the data files.
  264.    + If the censor is enabled, any text is now filtered out as the user enters
  265.      it rather than after he hits [Enter] on the string.
  266.    + Users with SysOp access may now view the results of a booth before voting
  267.      for it, however the unvoted booths are still dimmed out so as to show him
  268.      which booths he hasn't voted for yet and which ones he did.
  269.    + Added word wrap to the log file so the lines in the log should never go
  270.      past the end of the screen any more.
  271.    > Fixed a bug where DCT-Vote would return the locked baud rather than the
  272.      caller's baud rate when DOOR.SYS was selected as the drop file.
  273.    + Users may now add comments using aliases they have selected.  The
  274.      structure to the comment file has also changed to accomodate this new
  275.      feature.
  276.    + The voting results screen is now displayed line by line rather than first
  277.      the left column, then the answer box (it just looks better this way :).
  278.    * Removed the date-check routine that many of you will soon be noticing in
  279.      v0.11. =)
  280.    + Added the booth editor.
  281.    + You may now force users to vote for a booth (they can't hit ESC).  This
  282.      is, of course, a SysOp-only feature (and can only be turned on in the
  283.      booth editor :).
  284.    + The spinning stick may now be configured.  This little feature really
  285.      makes the door look different.  One interesting possibility is to make
  286.      the string "█▓░▒▓" which gives a pulsing effect and does away with the
  287.      stick completely.
  288.    + Improved the colour configuration menu.
  289.    + Made a slight change to the DCT-Vote logo in the main menu.
  290.  
  291.  
  292.  Version 0.11ß -=- April 17, 1996.
  293.    * This version is mainly just a bug fix from v0.10 and also contains a few
  294.      new things that I forgot to add in the previous version or never got
  295.      around to adding.
  296.    > Aaarrgh!  The day it's released and already I find a bug!  The user
  297.      time-out wouldn't activate if a user was at one of those spinning stick
  298.      prompts; the stick would just spin endlessly until he hit a key. :(  Well
  299.      it's fixed now.
  300.    * If no booths exist (ie. a new copy was just installed), DCT-Vote now
  301.      creates a default booth.  I just felt like doing this. :)
  302.    > Fixed a bug in the voting results screen where the title would sometimes
  303.      not be displayed properly.  This bug's been around since the first ßeta,
  304.      I just found it out now.
  305.    + DCT-Vote now shows the user which answer he voted for when displaying the
  306.      voting results.
  307.    + DCT-Vote now shows the user when the booth was created in the voting
  308.      results.
  309.    > If the SysOp had the Auto-Vote feature in use and a user whose terminal
  310.      didn't support ANSI entered, DCT-Vote would display to them the message
  311.      telling them they didn't have ANSI.  It now simply exits without
  312.      bothering the user about it every time s/he logs in.
  313.    + DCT-Vote will now allow users to create a new voting booth when they
  314.      login using the auto-vote feature.
  315.    > Fixed a bug in the string entry prompts.
  316.    > If the user left a comment on a booth whose question was two lines, the
  317.      "Press any key to continue" prompt would be displayed on the bottom
  318.      border line and mess up the display.  Fixed.
  319.    + Users can't just hit [Enter] on the first answer in auto-vote any more
  320.      (it forces them to think about which answer to choose now >;).
  321.    * It takes less time to save the voting results now (the program used to be
  322.      re-writing the whole vote file before - now it just saves the booth voted
  323.      on).
  324.    + Added colour configuration.
  325.    > Fixed a bug where DCT-Vote would sometimes crash if you tried deleting a
  326.      booth and comments had been written on it.
  327.    > Booths being deleted during maintenance were destroying the data files,
  328.      making the whole voting door have to be reset.  This has thankfully been
  329.      fixed. :)
  330.    + Added an error handler.  If a runtime error occurs, it will be logged in
  331.      the log file.
  332.    > If a user left a comment that was 5 lines long, DCT-Vote would not save
  333.      the last line.  Fixed.
  334.  
  335.  
  336.  Version 0.10ß -=- February 17, 1996.
  337.    * Well there have been MANY changes in this version from the previous
  338.      one, though many of them won't even be seen by the users.  Setup and
  339.      installation for the SysOp should be much easier now.
  340.    > If a booth was deleted and the comment file was empty, the program would
  341.      terminate with a runtime error.  Fixed.
  342.    + If there are booths which the user hasn't voted for yet, DCT-Vote now
  343.      tells them that in the main menu.
  344.    + Added the user time-out.  If the user doesn't press anything for 120
  345.      seconds, s/he is returned to the BBS.
  346.    + Added the auto-vote feature.
  347.    + The docs look a *LOT* better now. :)
  348.    > Oooh.  Bad bug.  On one BBS, when you hit a cursor key on the remote end,
  349.      DCT-Vote would act as if the user hit [ESC] because it didn't wait long
  350.      enough to see if more characters had been sent.  (When the user hits a
  351.      cursor key, the terminal program sends ASCII character #27 followed by
  352.      "[A" or whatever the code is, and DCT-Vote didn't wait long enough for
  353.      the "[A" part.)
  354.    > Fixed a bug where if you hit backspace when selecting a booth, it
  355.      wouldn't write the "·" character remotely like it should have.
  356.    + You may now hit the first letter of the option in the sysop menu as well
  357.      as the number.  I did this to the main menu a few versions back but
  358.      somehow missed doing it in the SysOp menu.
  359.    + Finally!  I made a configuration program, so you won't have to worry
  360.      about the messy text configuration file any more.  Not all of the
  361.      features within it have been implemented yet.
  362.    + Users may now post booths anonymously if the SysOp allows it.  Please
  363.      keep in mind that if you have SysOp access, DCT-Vote will show you who
  364.      created the booth when voting, but to regular users it simply says
  365.      "Posted By: Anonymous".
  366.    * I made a little change to the voting results screen regarding the
  367.      percentage bar.
  368.    + Fixed up the string entry prompts a bit.
  369.    + Made a few subtle changes to the Yes/No prompt.
  370.    + Improved the program info screen.
  371.  
  372.  
  373.  Version 0.06ß -=- January 25, 1996.
  374.    * After releasing v.05 to be ßeta tested, I found a few bugs.  This version
  375.      has all of the bug fixes.
  376.    > OOPPS!!  There was a little bug where DCT-Vote wouldn't let users move
  377.      the lightbar onto the "create new booth" if they didn't have sysop
  378.      access.  They could still create booths by hitting "3" though.
  379.    > If you had the status bar turned off and hit F1 to display the help, it
  380.      would go back on.  Fixed.
  381.    > If the user's name was only one word, DCT-Vote would add a trailing space
  382.      character to it.  Fixed.
  383.  
  384.  
  385.  Version 0.05ß -=- January 23, 1996.
  386.    * This version has some nice new features, and a few bug fixes as well.  I
  387.      still have to add file-locking though, and eventually when I get around
  388.      to it, I'll rearrange the file structure so that DCT-Vote can support an
  389.      unlimited amount of booths and answers per booth.
  390.    > Fixed the spinning stick in the "Press any key" prompts.  It worked fine
  391.      locally, but remotely it screwed up with some terminal programs.
  392.    + Added the "user comments".
  393.    + Added the "@" random filter character macro.
  394.    + Added a minimum security level to create a booth.
  395.    + You may now hit the first letter of the option in the main menu as well
  396.      as the number.
  397.    + If the user enters an invalid booth number, it now informs him of that
  398.      instead of returning to the main menu.
  399.    > If a user whose terminal program doesn't support ANSI enters the door, it
  400.      will now display a message to him informing him that he must have ANSI.
  401.  
  402.  
  403.  Version 0.01ß -=- January 7, 1996.
  404.    * My initial creation of DCT-Vote.  I'll be playing around with the data
  405.      file formats in the next few versions until I find something that I like
  406.      and that is easy to work with.
  407.  
  408.  
  409. ▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀■▄■▀
  410.  
  411. {EOF}
  412.